home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 002a / sts9123.zip / QUICK!.DOC < prev    next >
Text File  |  1991-06-02  |  11KB  |  224 lines
  1.    Program STSORBIT Space Shuttle Orbit Simulation                    Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                 Program STSORBIT
  8.  
  9.                   Space Shuttle and Satellite Orbit Simulation
  10.  
  11.  
  12.  
  13.                                   Version  9123
  14.                                   June 01, 1991
  15.  
  16.  
  17.  
  18.  
  19.                              by David H. Ransom, Jr.
  20.                              Rancho Palos Verdes, CA
  21.  
  22.                                BBS: (213) 541-7299
  23.  
  24.  
  25.  
  26.    BRIEF PROGRAM INSTRUCTIONS
  27.    --------------------------
  28.  
  29.         This file is intended to help the experienced user get started with 
  30.    program STSORBIT. It is NOT intended to be a substitute for the full 
  31.    program documentation!
  32.         STSORBIT is a program to track the NASA Space Shuttle and other 
  33.    satellites. Orbital data may be entered manually for space shuttle missions 
  34.    and NASA/NORAD 2-line elements may be used for all satellites as well as 
  35.    for the space shuttle when available.
  36.         The following steps should get the program "up and running" with as 
  37.    little fuss and bother as practical.
  38.  
  39.    1.   For hard disk users: Copy all files to a subdirectory called STSORBIT.
  40.  
  41.         For floppy disk users: Copy all files to a separate floppy disk.
  42.  
  43.    2.   For hard disk users: Log into the STSORBIT subdirectory using the 
  44.         following commands (which assume drive C:):
  45.  
  46.              C:
  47.              CD \STSORBIT
  48.  
  49.         For floppy disk users: Log into the floppy disk (drive A: assumed):
  50.  
  51.              A:
  52.  
  53.    3.   If you have used a previous version of STSORBIT, delete the file 
  54.         STSORBIT.INI. This will eliminate any problems if the format of the 
  55.         .INI file has changed and will reset all features to their default 
  56.         conditions.
  57.  
  58.    4.   Enter the following command to start the program:
  59.    Program STSORBIT Space Shuttle Orbit Simulation                    Page 2
  60.  
  61.  
  62.  
  63.              STSORBIT            (for all CGA/EGA/VGA color systems)
  64.  
  65.              STSORBIT /M         (for all monochrome systems)
  66.  
  67.    5.   The program should start and load its map data. Then a screen will 
  68.         appear which requests that you set the UTC Offset for your time zone. 
  69.         Follow the on-screen instructions and enter the UTC Offset and the 
  70.         Daylight Flag.
  71.  
  72.    6.   The STSORBIT Main Menu will now appear. Press F1 for a demonstration 
  73.         of the program. Press ENTER to stop the demonstration and return to 
  74.         the Main Menu.
  75.  
  76.    7.   The distribution package includes a set of NASA 2-line elements with a 
  77.         name like NASA849.TXT. This contains orbital information on over 100 
  78.         different satellites. Press F2 to load orbital information. The screen 
  79.         will display a list of files having the extension .TXT. The 
  80.         NASAnnn.TXT file should be one of them. Enter the file name at the 
  81.         prompt and press ENTER. 
  82.  
  83.    8.   The program will ask what satellite you wish to view with a default 
  84.         response of "HST" (meaning the Hubble Space Telescope). Press ENTER to 
  85.         accept the default or enter another satellite name (such as "MIR" or 
  86.         "TDRS"). If the name of the data file begins with the letters "STS", 
  87.         the default satellite name will be "STS".
  88.  
  89.    9.   The program will search the data file for the requested satellite and 
  90.         display its orbital data if found. If this is the satellite you wish, 
  91.         press ENTER when asked. Press SPACE to continue searching.
  92.  
  93.    10.  After the satellite has been selected, STSORBIT will now display a map 
  94.         of the world and the ground track of the satellite. The satellite 
  95.         itself will be a white symbol along the ground track. EGA and VGA 
  96.         systems will display in color; CGA and HGC systems will display in 
  97.         monochrome. Press Function Key F1 for on-line help while the ground 
  98.         track is displayed.
  99.  
  100.    11.  Press ENTER at any time to return to the Main Menu.
  101.  
  102.    12.  To display a space shuttle mission, press F4 to enter orbital 
  103.         information in STSORBIT's simple orbital model. Enter the launch time 
  104.         and date in local time (or use UTC by adding "U" at the end of the 
  105.         time entry). If you know the orbital altitude and inclination, enter 
  106.         that information; otherwise, press ENTER to accept the default data. 
  107.         More accurate NASA 2-line elements are usually available within 24 
  108.         hours of a space shuttle launch.
  109.  
  110.    13.  STSORBIT has many features which are fully described in the program 
  111.         documentation. Please read that documentation!
  112.  
  113.    14.  The latest version of STSORBIT and current NASA 2-line elements are 
  114.         always available on my bulletin board system: RPV ASTRONOMY BBS at 
  115.         (213) 541-7299, 2400/1200 baud, 8-N-1. The system has a power 
  116.         controller; if it hasn't answered after the FOURTH RING, hang up and 
  117.    Program STSORBIT Space Shuttle Orbit Simulation                    Page 3
  118.  
  119.  
  120.         call back in two minutes. This is a free access BBS with 100MB of 
  121.         files and is often busy, so please be patient.
  122.  
  123.  
  124.    USING MISSION ELAPSED TIME WITH 2-LINE ELEMENTS
  125.    -----------------------------------------------
  126.  
  127.         The standard NASA/NORAD 2-line orbital element format does not include 
  128.    the launch time or launch date. However, this information is obviously 
  129.    required if Mission Elapsed Time (MET) is to be displayed. That information 
  130.    must therefore be obtained independently and manually entered into the 
  131.    program. The following steps are required:
  132.  
  133.    1.   Start program STSORBIT (see above).
  134.  
  135.    2.   Now load the desired 2-line elements using Function Key F2 on the Main 
  136.         Menu. Press ENTER to return from the ground track display to the Main 
  137.         Menu.
  138.  
  139.    3.   Press Function Key F5 to adjust the orbital information. Since you are 
  140.         using 2-line elements, the only questions asked will be Launch Time 
  141.         and Launch Date. Enter the appropriate information. Note that if you 
  142.         enter UTC or GMT Launch Time (by adding the letter "U" or "G" at the 
  143.         end of the time, upper or lower case), STSORBIT assumes that the date 
  144.         you enter will also be the UTC Launch Date.
  145.  
  146.    4.   The information will be displayed for approval. Press ENTER to accept 
  147.         the data, or press SPACE BAR to repeat the process.
  148.  
  149.    5.   Once the data have been accepted, press Function Key F6 to display 
  150.         Mission Elapsed Time. Press F6 again to return to Time Elapsed Since 
  151.         Epoch. While the ground track is displayed, Function Key F5 may be 
  152.         pressed to switch between the two elapsed time calculations. (Press 
  153.         Function Key F1 for help during the ground track display.) If a launch 
  154.         time and date have not been entered, these commands will have no 
  155.         effect and time since epoch will always be displayed.
  156.  
  157.         The launch time and launch date will be saved in file STSORBIT.INI and 
  158.    need only be entered once. Note, however, that this information must be 
  159.    changed or cleared if you change satellites (since it is saved 
  160.    independently of the 2-line elements file!). If you display MET for more 
  161.    than one satellite, it is a good practice to copy file STSORBIT.INI into a 
  162.    backup file (say, HST.INI for the Hubble Space Telescope) once you have set 
  163.    the launch time and date. You may then use Function Key F3 from the Main 
  164.    Menu to reload that file.
  165.  
  166.         The simulated time, taking into account any fast time that may have 
  167.    been in effect up to that point, is shown at the lower left of the screen. 
  168.    For reference, the launch or epoch time and the actual local time (as 
  169.    determined by the computer's internal DOS clock) are also displayed. The 
  170.    MET (Mission Elapsed Time) or T+Epoch display at the lower right of the 
  171.    screen shows the current elapsed time in the mission and will include an 
  172.    additional message, "(x10)" or "(x60)", when fast time is in effect.
  173.  
  174.         The combination of the FAST and PAUSE modes will let you "look 
  175.    Program STSORBIT Space Shuttle Orbit Simulation                    Page 4
  176.  
  177.  
  178.    ahead" and then freeze the display at a time of interest -- such as when 
  179.    the satellite enters your circle of visibility. You can then use the "+" 
  180.    and "-" keys to move the satellite position back and forward in time (using 
  181.    Function Key F6 to select the time step interval, 1, 10 or 60 seconds) to 
  182.    determine the times and positions throughout a pass.
  183.  
  184.         One other suggestion: When you use the PAUSE mode (with or without the 
  185.    "+" and "-" keys), a good practice is to press ENTER twice after you exit 
  186.    the PAUSE mode to return to the Main Menu and then restart the ground track 
  187.    display. This resets the position and times to the current time.
  188.  
  189.  
  190.    USERS WITHOUT A MATH COPROCESSOR CHIP
  191.    -------------------------------------
  192.  
  193.         STSORBIT makes very complex calculations to determine the position of 
  194.    the Earth, Satellite, and Sun. In addition, graphics operations required to 
  195.    display the world map and the satellite track and position also require 
  196.    many computer calculations. Slow computers or computers not equipped with a 
  197.    math coprocessor chip (8087, 80287, 80387, etc.) may not be able to perform 
  198.    all of the required calculations and still keep the display synchronized to 
  199.    real time.
  200.         In order to allow these computers to run STSORBIT and provide most of 
  201.    the available features, a special SLOW MODE is available which bypasses or 
  202.    simplifies some of the more complex or time consuming calculations and cuts 
  203.    the display update frequency from once per second to once per five seconds. 
  204.    From the Main Menu, press Function Key F10 followed by F7. This will 
  205.    disable the spacecraft circle of visibility feature as well as slowing the 
  206.    display update cycle to every five seconds instead of every second. Note 
  207.    that the Sun terminator feature is NOT disabled; however, slower computers 
  208.    without a math coprocessor chip will be unable to keep up with real time if 
  209.    this feature is enabled.
  210.  
  211.  
  212.    PROGRAM REGISTRATION
  213.    --------------------
  214.  
  215.         See the file REGISTER for information on registering STSORBIT. While I 
  216.    do not require registration of STSORBIT, I've put a great deal of time and 
  217.    effort into the program for more than two years. Registering your copy and 
  218.    sending along the very modest contribution will encourage me to continue 
  219.    maintaining and improving the program.
  220.  
  221.                                                 David H. Ransom, Jr.
  222.                                                 7130 Avenida Altisima
  223.                                                 Rancho Palos Verdes, CA  90274
  224.